<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" Content="text-html; charset=Windows-1252">
<title>ALink</title>
<style>@import url(coUA.css);</style>
<link disabled rel="stylesheet" href="htmlhelp.css">
</HEAD>

<BODY>
<h1>ALink command</h1>

<h2>Purpose</h2>

<p>Creates Associative links (ALinks) that jump to target HTML files that contain the specified ALink names. The list of target topics appears <a href="window_types.htm">on a pop-up menu or in a dialog box</a>.</p>

<p>This command can be used only with a compiled help (.chm) file.</p>

<h2>Syntax</h2>
<p><pre><code>
<br>&lt;PARAM  name="Command"       value="ALink [,menu|,dialog]"&gt;
<br>&lt;PARAM  name="Item1"         value="<i>.chm file path</i>"&gt;
<br>&lt;PARAM  name="Item2"         value="<i>ALink text</i>"&gt;
<br>[&lt;PARAM name="Button"        value="[Text: <i>Button text</i>|Bitmap:<i>Bitmap file path</i>|Icon:<i>Icon file path</i>]"&gt;]
<br>[&lt;PARAM name="Default Topic" value="<i>File name or HTTP URL</i>"&gt;]
<br>[&lt;PARAM name="Font"          value="<i><i>Facename[, point size[, charset[, color[, PLAIN BOLD ITALIC UNDERLINE]]]]</i></i>"&gt;]
<br>[&lt;PARAM name="Flags"         value=",,1"&gt;]
<br>[&lt;PARAM name="Flags"         value="1"&gt;]
<br>[&lt;PARAM name="Frame"         value="<i>Frame Name</i>"&gt;]
<br>[&lt;PARAM name="Text"          value="Text: <i>Link text</i>"&gt;]
<!--br>[&lt;PARAM name="Window"     value="<i>Window Name</i>"&gt;]-->
</pre></code></p>

<br>
<table border=1 cellpadding=0 cellspacing=0 width=100%>
<tr valign=top>
<th width=25%>
<b>Property</b>
</th>
<th>
<b>Description</b>
</th>
</tr>

<tr valign=top>
<td>
<a href="ocx_pbutton.htm">Button</a>
</td>

<td>
Specifies the button style. Optional.
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pcommand.htm">Command</a>
</td>

<td>
Calls the <b>ALink</b> command and specifies whether to display target topics <a href="window_types.htm">on a pop-up menu or in a dialog box</a>.

<p>If you do not specify a display option, a dialog box appears by default.</p>

<p>To specify the <b>Topics Found</b> dialog box, type <b>dialog</b>.</p>

<p>To specify a pop-up menu, type <b>menu</b>.</p>
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pdefault_topic.htm">Default Topic</a>
</td>

<td>
Specifies the topic to navigate to if the look up fails. Optional.
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pflags.htm">Flags</a>
</td>

<td>
Specifies how to behave if only one target is found or if the target is unavailable.
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pfont.htm">Font</a>
</td>

<td>
Specifies the font attributes. Optional.
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pframe.htm">Frame</a>
</td>

<td>
Specifies the frame in which to display the selected topic. Optional.
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pitem.htm">Item1</a>
</td>

<td>
Specifies the compiled help file that contains the target topics.
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_pitem.htm">Item2</a>
</td>

<td>
Specifies the text for one ALink name. This text must match an ALink name that has previously been inserted into one or more topics using the <b>Compiler Information</b> feature.
<p>Subsequent ALink names are specified as Item3, Item4, etc.</p>
</td>
</tr>

<tr valign=top>
<td>
<a href="ocx_ptext.htm">Text</a>
</td>

<td>
Specifies the link text. Optional.
</td>
</tr>

<!--tr valign=top>
<td>
<a href="ocx_pwindow.htm">Window</a>
<td>
Specifies the target window in which to display the selected topic. Optional.
</td>
</tr-->
</table>


<h2>Example</h2>

<p>Note that in this example ALink targets will appear in the <b>Topics Found</b> dialog box because neither <code>dialog</code> nor <code>menu</code> is specified in the <b>Command</b> parameter value.</p>

<p><pre><code>
&lt;OBJECT
<br>  id=MyControl
<br>  type=&quot;application/x-oleobject&quot;
<br>  classid=&quot;clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11&quot;
<br>  codebase=&quot;HHCTRL.ocx#Version=4,72,8252,0&quot;
<br>  width=100
<br>  height=100
<br>&gt;
<br>  &lt;PARAM name=&quot;Command&quot; value=&quot;ALink&quot;&gt;
<br>  &lt;PARAM name=&quot;Button&quot; value=&quot;Text:See Also&quot;&gt;
<br>  &lt;PARAM name=&quot;Item1&quot; value=&quot;c:\Help\MyFile.chm&quot;&gt;
<br>  &lt;PARAM name=&quot;Item2&quot; value=&quot;overview&quot;&gt;
<br>  &lt;PARAM name=&quot;Item3&quot; value=&quot;bibliography&quot;&gt;
<br>&lt;/OBJECT&gt;
</pre></code></p>

<h2>Sample ALink command</h2>
<OBJECT id=ALinks type="application/x-oleobject"
        classid="clsid:adb880a6-d8ff-11cf-9377-00aa003b7a11"
        width=100
        height=100
>
    <PARAM name="Command" value="ALink, MENU">
    <PARAM name="Button" value="Text:HTML Help ActiveX control overview topics">
    <PARAM name="Flags" value="1">    
    <PARAM name="Item1" value="hhaxref.chm">
    <PARAM name="Item2" value="overview">
    <PARAM name="Item3" value="commands">
    <PARAM name="Item4" value="parameters">
	<PARAM name="Item5" value="methods">
    <PARAM name="Item6" value="scripts">
</OBJECT>

<h2>Comments</h2>
<ul>
<li>The <b>Button</b> parameter is omitted when this command is invoked by a script.</li>

<li>To add ALink names to an HTML file, use the <b>Compiler Information</b> command, which is available on the <b>Edit</b> menu of HTML Help Workshop.</li>
</ul>

<br>
<table border="0" cellpadding="0" cellspacing="4">
<tr>
<td valign="top"><a href="ocx_commands.htm"><img src="proced.gif" alt="link to overview topic" border="0"></a>
</td>
<td><a href="ocx_commands.htm">About commands</A></td>
</tr>
<tr>
<td>&nbsp;</td>
</tr>
</table>

</BODY>
</HTML>
